home *** CD-ROM | disk | FTP | other *** search
/ Graphics Plus / Graphics Plus.iso / general / modelers / geomview / sgi.lha / Geomview / man / cat1 / crayola.1 < prev    next >
Text File  |  1993-03-02  |  5KB  |  133 lines
  1.  
  2.  
  3.  
  4. crayola(1)                           crayola(1)
  5.  
  6.  
  7. NAME
  8.        crayola    - Geomview external module to color OOGL objects.
  9.  
  10. SYNOPSIS
  11.        crayola
  12.  
  13. DESCRIPTION
  14.        Crayola is a Geomview external  module  used  to     interac-
  15.        tively  color  OOGL  objects.   Crayola    should    appear in
  16.        Geomview's external module browser automatically    after  it
  17.        has been    properly installed.  If    this does not happen, add
  18.        the line
  19.  
  20. (emodule-define    Crayola    crayola)
  21.        to  your      .geomview   file   (for   more   details,   see
  22.        geomview(5)).   Click  on  Crayola in the browser to start
  23.        the program.
  24.  
  25.  
  26.        The buttons at the top of the Crayola main panel    state the
  27.        mode  that  the    program     is in.     It begins in "Get" mode,
  28.        meaning that picking an object in Geomview (by moving  the
  29.        cursor  over  the object    in the camera window and pressing
  30.        the right mouse button) will adjust the colorwheel to show
  31.        the  color  of  the object at the chosen    location.  In the
  32.        Silicon Graphics    Iris version, the colorwheel  is  located
  33.        on the main panel.  Click with the mouse    to move    the black
  34.        dot around and change the color    selection.   The  "Inten-
  35.        sity" slider is used to make the    colors darker or lighter.
  36.        The slider starts set to    the far    left, or full  intensity.
  37.        Moving  the  slider  to the right will decrease the inten-
  38.        sity, until, at the far right, the color    wheel is entirely
  39.        black.    The second slider, marked "Opacity," will be dis-
  40.        cussed later.  In the NeXT version, the color picker panel
  41.        will pop    up seperately (The color picker    may be set to use
  42.        a different color selection mode    than the colorwheel).
  43.  
  44.        Colors may be assigned to  parts     of  an     OOGL  object  by
  45.        clicking     the  "Set"  button on the Crayola main    panel and
  46.        picking the object in the  Geomview  camera  window.   The
  47.        object  may not already have color information; if this is
  48.        the case    a panel    will pop up asking if  you  want  to  add
  49.        color  information  to the object.  Clicking on "Yes" will
  50.        modify the object to include color information.
  51.  
  52.        Each OOGL object    has a slightly different scheme    for  rep-
  53.        resenting  color.   For example,    quads are colored by ver-
  54.        tex, while polylists may    be colored by face or  by  vertex
  55.        and  Bezier  patches  are  colored  by  patch corner.  See
  56.        oogl(5) for a detailed discussion  of  which  object  uses
  57.        which coloring scheme.  Generally, in Crayola, clicking on
  58.        a face will color that entire face with the  given  color,
  59.        either  by  changed  the     color assigned    to the face or by
  60.        changed the color assigned to each of the vertices of  the
  61.  
  62.  
  63.  
  64. Geometry Center         January 12, 1993            1
  65.  
  66.  
  67.  
  68.  
  69.  
  70. crayola(1)                           crayola(1)
  71.  
  72.  
  73.        face.  If per-vertex coloring is    being used, the    colors of
  74.        the vertices may    be changed individually     by  clicking  on
  75.        them.
  76.  
  77.        An  entire object may be    colored    by clicking the    "Set All"
  78.        button and picking it in    Geomview.
  79.  
  80.        Color information may be    removed    from an    object by  click-
  81.        ing the "Eliminate Color" button    and picking on the object
  82.        in Geomview.
  83.  
  84.        Crayola remembers the last change you made to the  object,
  85.        so  clicking  on     the  "Undo" button will get rid of minor
  86.        mistakes.  Note that ONLY the last change is remembered.
  87.  
  88.        Crayola has the ability to assign colors    containing  opac-
  89.        ity  information    (alpha values) to Geomview objects.  How-
  90.        ever, transparent objects are supported only on some  com-
  91.        puters (eg Iris GTX's, VGX's, Crimsons, and high-end Indi-
  92.        gos).  The opacity of the current color may be modified by
  93.        moving  the opacity slider (on the main panel on    SGI's and
  94.        the color picker    panel on NeXT's).   On    Silicon     Graphics
  95.        computers  supporting  transparency,  the  colorwheel will
  96.        fade in and out as the slider is    moved back and forth.  On
  97.        NeXTs,  the  upper right    portion    of the color in    the color
  98.        well will become    lighter.  If the opacity slider    is  in    a
  99.        position    other than to the far right, the current color is
  100.        partially transparent.  This information    will be     assigned
  101.        to  the object along with all the other color information.
  102.        In order    for  the  given     color    to  look  transparent  in
  103.        Geomview,  transparency    must  be explicitely turned on in
  104.        Geomview    (see Geomview(5) for details on    how to do  this).
  105.  
  106. SEE ALSO
  107.        geomview(1), geomview(5), oogl(5)
  108.  
  109. AUTHOR
  110.        Celeste Fowler               email:  fowler@geom.umn.edu
  111.        The Geometry Center           phone:  (612) 626-8304
  112.        1300 South Second Street
  113.        Minneapolis, MN    55454
  114.  
  115.  
  116.  
  117.  
  118.  
  119.  
  120.  
  121.  
  122.  
  123.  
  124.  
  125.  
  126.  
  127.  
  128.  
  129.  
  130. Geometry Center         January 12, 1993            2
  131.  
  132.  
  133.